home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir24 / bspi108g.zip / BPQSPI.DOC next >
Text File  |  1994-01-27  |  10KB  |  256 lines

  1.                                   BPQSPI
  2.         The Serial Port Telephone Interface for G8BPQ network nodes.
  3.                       Written by Larry Houbre, AA1FS
  4.  
  5.  
  6. ========
  7. Overview
  8. ========
  9.  
  10. BPQSPI allows you, the G8BPQ node sysop, and your users access to your
  11. network node via a telephone modem. Once connected to BPQSPI, after a
  12. simple log-in process, the user is connected to the node and may then
  13. invoke any of the node commands, connect to any of the nodes on the node
  14. list, or to the accompanying BBS. Quite simply, using BPQSPI is
  15. identical to being on packet...but over the phone!
  16.  
  17.  
  18. ==============================
  19. Program and accompanying files
  20. ==============================
  21.  
  22. The following files are standard with the program, and will come
  23. archived in BSPI***.LZH or BSPI***.ZIP, where *** is the numerical
  24. version of the software.
  25.  
  26. FILENAME      DESCRIPTION
  27. ------------  ---------------------------------------------------
  28. BPQSPI.EXE    The executable file, which runs as a TSR (terminate
  29.               and stay resident) program.
  30. BPQSPI.USR    An example of the user file.
  31. BPQSPI.DOC    This documentation.
  32.  
  33. The following optional files can be added to enhance operation of your
  34. BPQSPI system. They ARE NOT included in the archived file.
  35.  
  36. FILENAME      DESCRIPTION
  37. ------------  ---------------------------------------------------
  38. BPQSPI.HLP    Offers a brief helpfile for users working at the
  39.               BPQSPI prompt. Should be no more than 300 characters.
  40. BPQSPI.HI     Used to create a brief log in message. Should be no
  41.               more than 300 characters.
  42. BPQSPI.MI1    A set of actual modem commands to be sent to the
  43.               modem at start up.
  44. BPQSPI.MI2    A set of actual modem commands to be sent to the
  45.               modem between callers.
  46.  
  47.  
  48. =============
  49. BPQSPI setup.
  50. =============
  51.  
  52. Initial setup of BPQSPI is very simple and is completed in four steps.
  53.  
  54. Step 1 - Installation
  55. ---------------------
  56. Unarchive the program, and copy its files into your BPQ directory. All
  57. pertinent files should be in this directory to ensure proper operation
  58. of BPQSPI.
  59.  
  60. Step 2 - Modification of AUTOEXEC.BAT file.
  61. -------------------------------------------
  62. Add the following line to your AUTOEXEC.BAT file. This line must be
  63. inserted BEFORE any of the G8BPQ files are loaded! Ideally, insert
  64. this line just above your BPQ files.
  65.  
  66. BPQSPI switchname port baud
  67.  
  68. Where Switchname = Node Switch's ALIAS, i.e. WHALE
  69. Where Port       = Com port, 1-8
  70. Where Baud       = Baud rate, 300 to 115200
  71.  
  72. Example: BPQSPI WHALE 1 19200
  73.  
  74. The above example shows the node alias as WHALE. The modem is connected
  75. to the computer's com port 1, and the modem's speed is 19,200 baud.
  76.  
  77. Provided the above info is correct and the line is added BEFORE any of
  78. the other BPQ files in AUTOEXEC.BAT, the program will load, terminate,
  79. and stay resident, operating in the background.
  80.  
  81. Note: If using non-standard port addresses or IRQs, you can and must
  82. specific the port address and IRQ as $h,i. For example, port address
  83. $3F8 and IRQ 5 would be   BPQSPI WHALE $3F8,5 19200
  84.  
  85. Step 3 - Modification of BPQCFG.TXT file.
  86. -----------------------------------------
  87. BPQSPI fools G8BPQ into thinking it is talking to a KISS TNC, when of
  88. course it is actually talking to a modem. A port must be added to
  89. BPQCFG.TXT. Follow the forthcoming example as a guideline, changing your
  90. IOADDR and SPEED as necessary.
  91.  
  92. PORT
  93.        ID=MODEM
  94.        TYPE=EXTERNAL
  95.        PROTOCOL=KISS
  96.        IOADDR=3F8H     (3F8H=com1, 2F8H=com2, 3E8H=com3, 2E8H=com4)
  97.        INTLEVEL=120    (absolutely DO NOT change this!)
  98.        SPEED=19200     (computer to modem speed)
  99.      * CHANNEL=A
  100.        QUALITY=0       (no need for nodes broadcasts to a modem!)
  101.        MAXFRAME=3
  102.      * TXDELAY=35
  103.      * SLOTTIME=100
  104.      * PERSIST=100
  105.      * FULLDUP=1
  106.      * SOFTDCD=1
  107.      * FRACK=1000
  108.      * RESPTIME=2000
  109.      * RETRIES=3
  110.      * PACLEN=225
  111. ENDPORT
  112.  
  113. The values of the above parameters marked with astericks are irrelevent,
  114. however they MUST be in the port configuration for BPQSPI to function!
  115. Remember, BPQ thinks this is a KISS TNC it's talking to. You'll also
  116. likely want to add a little blurb in BPQ's info file section reflecting
  117. the addition of the phone port. Remember to run BPQCFG.EXE to compile
  118. the changes to BPQCFG.TXT.
  119.  
  120. Step 4 - Create/edit the BPQSPI.USR file.
  121. -----------------------------------------
  122. BPQSPI.USR can be created or edited using any ascii editor, such as
  123. DOS 5 or 6 EDIT, QEDIT, and others. Follow the format in the example
  124. below.
  125.  
  126. AA1FS TEST
  127. KC1UA BETATEST
  128. WA1YKN NETWORK
  129.  
  130. Use the actual callsign only, DO NOT use packet radio SSID's (KC1UA-1
  131. won't work). Users MUST have a password in order to connect to the node.
  132. The BPQSPI.USR file may be edited in real time; there is no need to
  133. reboot the system after adding a new call and password to the file.
  134.  
  135. Optional Step - Modem Init File(s)
  136. ----------------------------------
  137. At start up, BPQSPI will send the following commands to the modem:
  138.  
  139.   ATZ
  140.   ATV0
  141.   ATE0
  142.   ATQ1
  143.   ATM0
  144.   ATS0=1
  145.   ATS7=60
  146.  
  147. If you wish to change some modem parameters, you can create a file named
  148. BPQSPI.MI1, which will simply be sent to the modem AFTER the above commands.
  149. The line in the file should be a complete modem command WITH the AT prefix.
  150.  
  151. In addition, after BPQSPI hangs up, it will send any commands found in the
  152. file BPQSPI.MI2 if it exists. This file should have as few commands as
  153. possible to reset the modem between calls.
  154.  
  155. =====
  156.  
  157. Your BPQSPI setup is now complete! Provided the above was done properly,
  158. a reboot of your system should initialize your modem, put it in auto
  159. answer mode, and render BPQSPI ready to take your users' phone calls.
  160.  
  161.  
  162. ============
  163. Using BPQSPI
  164. ============
  165.  
  166. 1. Dial the BPQSPI number using your favorite communications software.
  167. 2. You will receive the CONNECT SPEED (i.e. CONNECT 14400) message.
  168. 3. Wait for the BPQSPI *.** prompt (where *.** is the software version)
  169.    to appear on screen. BE PATIENT! Some systems seem to take up to 45-50
  170.    seconds before this prompt appears. This is something that will be
  171.    addressed in future versions of the software. If the sysop has
  172.    created the BPQSPI.HI file, you will also see a brief log on message.
  173. 4. Type L, followed by your callsign and password, to log in. (i.e.
  174.    L KC1UA BETATEST). This may be in either upper or lower case letters.
  175.    You will then see a message indicating you're logged in.
  176. 5. You are now at the BPQSPI prompt. Typing a question mark and hitting
  177.    enter will provide the following help information:
  178.  
  179.    BPQSPI Commands:
  180.      B           - Quit BPQSPI (disconnects modem)
  181.      C           - Connect to Switch (connect to accompanying node)
  182.      ECHO on/off - Changes echo of characters you type (normally ECHO ON)
  183.      L call pass - Log in (initial login before connect to node)
  184.      LF on/off   - Changes status of adding linefeeds (normally LF ON)
  185.      S           - Status (shows settings and connect status)
  186.      SUI         - Show UI frames (allows monitor of certain packets)
  187.      ?           - This help
  188.      HELP        - Additional help file created by sysop (BPQSPI.HLP)
  189.  
  190. 6. To log onto the node, use the C command. You will then be connected
  191.    to the accompanying network node, and may then invoke any commands as
  192.    you normally would on packet radio. (HINT: When you connect from the
  193.    accompanying node to another node or BBS, use the S option at the end
  194.    of the connect string. An example of this is C SWL S. This will
  195.    connect you to the SWL node, but when you disconnect from it, you
  196.    will be returned to BPQSPI's accompanying node. If you do not use the
  197.    S option, you will be returned to the BPQSPI prompt and will have to
  198.    log back into the system again from there.)
  199. 7. To log off of the system, tell the node BYE in the usual manner by
  200.    typing B and hitting enter.
  201. 8. At this point, you are returned to the BPQSPI system, where you can
  202.    invoke any of the above commands. Another B logs you off of the
  203.    system. If you wish to access the node once again, you will need to
  204.    log back on with your callsign and password.
  205.  
  206.  
  207. ==========================
  208. Known problems for sysops.
  209. ==========================
  210.  
  211. 1. Initial delay in sending BPQSPI prompt. Seems to be random...some
  212.    modems display prompt immediately, while others can take up to 50
  213.    seconds or so before user is able to log in.
  214.  
  215.  
  216. =========================
  217. Known problems for users.
  218. =========================
  219.  
  220. 1. With the exception of the initial log on display experienced with
  221.    some systems, BPQSPI is essentially painless and simple for all users
  222.    to learn and operate.
  223.  
  224.  
  225. =======================
  226. Additional information.
  227. =======================
  228.  
  229. For sysops running AA4RE BBS in addition to BPQ: W1NPR has written a
  230. utility program, BBUCV3A.ZIP, that will convert AA4RE phone port users
  231. callsigns and passwords to the format used in BPQSPI.USR. Sure beats the
  232. pants off of doing it manually!
  233.  
  234. BPQSPI.EXE can be loaded high, provided you have a big enough upper
  235. memory block. BPQSPI uses about 85K, so it appears. If you wish to do
  236. so, ensure that you have the statement DOS=HIGH,UMB in your CONFIG.SYS
  237. file.
  238.  
  239. Sysops using DESQVIEW should ensure that BPQSPI is loaded before
  240. DesQView, and absolutely before any other BPQ files.
  241.  
  242. BPQSPI is free for use by Amateur Radio Operators in Amateur
  243. Radio Communications applications. Any other use is prohibited.
  244.  
  245. Please direct all comments to Scott/KC1UA@KC1UA.#EMA.MA.USA.NA. I will
  246. ensure that they are discussed/forwarded to Larry immediately. (Of course,
  247. a direct word of praise to Larry/AA1FS@AA1FS.#EMA.MA.USA.NA doesn't hurt.)
  248. If you would like to see BPQSPI in operation, drop a packet note to the
  249. above address and I will be glad to set you up with a password.
  250.  
  251. Messages can also be left the the landline BBS, Dreamer's BBS, at
  252. 508-991-6058 ... fidonet 1:329/863.
  253.  
  254. 73 and enjoy! Scott/KC1UA for Larry/AA1FS.
  255.  
  256.